Projekte automatisch erstellen oder bearbeiten

Neuron Power Engineer stellt ein Werkzeug für das automatisierte Erstellen oder Bearbeiten von Neuron Power Engineer-→Projekten zur Verfügung.

Gut zu wissen

(Graue Glühbirne) Das Werkzeug ist zur Verwendung durch einen fortgeschrittenen Anwender von Neuron Power Engineer vorgesehen.

(Graue Glühbirne)Bedingung für die erfolgreiche Verwendung des Werkzeugs sind Kenntnisse über die durchzuführende Aktion, wie sie in der grafischen Benutzeroberläche von Neuron Power Engineer ausgeführt werden würde.

(Graue Glühbirne)Die Ausgaben des Werkzeugs erfolgen nur in englischer Sprache.
In diesem Artikel:

Vorbereitungen

  1. Stellen Sie sicher, dass Neuron Power Engineer installiert ist. Halten Sie die folgenden Informationen bereit:

    • der Pfad zum Installationsverzeichnis von Neuron Power Engineer

    • der Pfad zu einem Verzeichnis, das als Arbeitsbereich verwendet wird
      Falls das Verzeichnis nicht existiert, wird es vom Werkzeug erstellt.

    • die Informationen für das Projekt, das erstellt oder bearbeitet werden soll – z.B. der Pfad und Name für das Projekt und die zu verwendende Projekt-Vorlage

    • der Pfad zur Konfigurationsdatei für das Protokoll (siehe unten für weitere Informationen)
      Eine Datei mit einer Beispielkonfiguration ist in der Installation von Neuron Power Engineer enthalten.

  2. Falls JAVA JDK nicht bereits auf Ihrem Computer installiert ist, installieren und entpacken Sie JAVA JDK. Erweitern Sie im Falle einer Installation auch die Umgebungsvariable PATH des Betriebssystems um das Verzeichnis, in das JAVA JDK installiert/entpackt wurde. Im Zweifelsfall bitten Sie Ihren Administrator um Unterstützung.

  3. Öffnen Sie eine Befehlszeile: z.B.  cmd.exe  unter Windows und wechseln Sie in das Installationsverzeichnis von Neuron Power Engineer.

Aufruf

@REM Commands to start the development environment in English
start cmd /c NeuronPowerEngineer.exe -nl en -data <WORKSPACE> -nosplash -vmargs -Dlicenseaccepted=true -Dosgi.requiredJavaVersion=<X.Y> -DLC3useRTS3MetaData=true -Xms256m -Xmx6144m -Dlc3.serverport=50055 -Dlog4j.configuration=file:<LOG-CONFIGURATION> 
ping 127.0.0.1 -n 40  1>NUL
 
@REM Command to create the project based on a template
java -jar util\com.logicals.lc3.command.jar -port 50055 --createProject -projectName <PROJECT> -targetPath <PROJECTPATH> -templateName <TEMPLATENAME>
 
@REM Command to modify the project (replace the content of a file in the project)
java -jar util\com.logicals.lc3.command.jar -port 50055 --modifyProject  -targetFilePath <FILE_TO_BE_MODIFIED> -sourceFilePath <REPLACEMENT_FILE> -binary
 
@REM Command to delete a file in the project
java -jar util\com.logicals.lc3.command.jar -port 50055 --removeProjectFile -targetFilePath <FILE_TO_BE_DELETED>
 
@REM Command to exit the development environment
java -jar util\com.logicals.lc3.command.jar -port 50055 -shutdown

Beschreibung der Parameter:

Parameter

Beschreibung

Beispiel

<WORKSPACE>

absoluter Pfad zu einem Arbeitsbereich, in den das Projekt importiert werden soll
Beachten Sie:

  • Das Verzeichnis des Arbeitsbereichs darf sich nicht innerhalb eines Verzeichnisses befinden, bei dem es sich um ein Neuron Power Engineer-Projekt handelt.

  • Nach dem Aufruf enthält der Arbeitsbereich einen Verweis auf das Neuron Power Engineer-Projekt. Das bedeutet, dass das Neuron Power Engineer-Projekt nicht in den Arbeitsbereich kopiert wurde.
    Dies ist das gleiche Verhalten wie innerhalb der grafischen Benutzeroberfläche von Neuron Power Engineer, wenn Sie den Befehl Importieren... und den Importtyp Vorhandene Projekte in den Arbeitsbereich mit der deaktivierten Option Projekte in Arbeitsbereich kopieren verwenden würden.

C:\temp\LC3Workspace

<X.Y>

Versionsnummer der benötigten Java-Version
Für diese Angabe öffnen Sie am besten die Datei NeuronPowerEngineer.ini, die im Installationsordner von Neuron Power Engineer vorhanden ist. Suchen Sie die Zeile mit dem Text -Dosgi.requiredJavaVersion=.  Übernehmen Sie die Angabe hinter = als die Versionsnummer.

1.8

<LOG-CONFIGURATION>

Pfad zur Konfigurationsdatei für das Protokoll
Alle Meldungen des Werkzeugs werden an das Gerät ausgegeben, das in der Konfigurationsdatei für das Protokoll angegeben ist.

C:\LC3LogConfig\log4j.xml

<PROJECT>

Name des Projekts, das erstellt werden soll

MyProject

<PROJECTPATH>

absoluter Pfad zum Ordner, in dem das Projekt erstellt werden soll

C:\Projects\

<TEMPLATENAME>

Name der Projektvorlage, auf deren Basis das Projekt erstellt werden soll
Die Dateien für die Projektvorlagen liegen im Unterordner templates\projects des Installationsordner von Neuron Power Engineer.
Der Name der Projektvorlage ist in der Datei Lc3Project.templateconf eingetragen. Falls die deutsche Sprachvariante von Neuron Power Engineer gestartet wird, geben Sie den deutschen Namen der Projektvorlage an. Falls der Name der Projektvorlage Leerzeichen enthält, geben Sie den Namen in "" an.

"Neuron Power Engineer Projekt"

<FILE_TO_BE_MODIFIED>

absoluter Pfad und Name der Datei, deren Inhalt ersetzt werden soll (= Original-Datei)
Falls diese Datei nicht vorhanden ist, wird sie automatisch von Neuron Power Engineer erstellt.

C:\LC3Projects\MyProject\TestNotes.txt

<REPLACEMENT_FILE>

absoluter Pfad und Name der Datei, deren Inhalt für die Ersetzung verwendet wird (= Ersatz-Datei)
Der Dateiname der Original-Datei bleibt bei der Ersetzung erhalten. Auf das Beispiel bezogen bedeutet das, dass der Inhalt von C:\LC3Projects\MyProject\TestNotes.txt durch den Inhalt von C:\Templates\DoneTests.txt ersetzt wird. Nach dem Ausführung des Befehls ist weiterhin die Datei TestNotes.txt im Projekt vorhanden.

(Info) Falls es sich bei der Ersatz-Datei um eine binäre Datei handelt, fügen Sie den Parameter -binary hinzu. Für nicht-binäre Dateien (z.B. Text-Dateien) ist der Parameter -binary nicht erforderlich.

C:\Templates\DoneTests.txt

<FILE_TO_BE_DELETED>

absoluter Pfad und Name der Datei, die gelöscht werden soll
Projekt-Ordner können mit Hilfe dieses Parameters nicht gelöscht werden.

C:\LC3Projects\MyProject\GenericTestNotes.txt

  • Dieser Parameter -noSplash  ist optional. Wird er nicht angegeben, wird der Startbildschirm von Neuron Power Engineer nach dem Aufruf angezeigt.

  • Dieser Parameter -Dlog4j.configuration ist ebenfalls optional. Neuron empfiehlt jedoch, diesen Parameter anzugeben, damit Protokoll-Ereignisse ausgegeben werden.

  • Alle anderen Parameter sind erforderlich. Falls sie nicht angegeben werden, weist eine entsprechende Meldung darauf hin, dass Parameter fehlen.

Beispiel für Aufruf

 
start cmd /c NeuronPowerEngineer.exe -nl en -data C:\temp\LC3Workspace -nosplash -vmargs -Dlicenseaccepted=true -Dosgi.requiredJavaVersion=1.8 -DLC3useRTS3MetaData=true -Xms256m -Xmx6144m -Dlc3.serverport=50055 -Dlog4j.configuration=file:C:\LC3LogConfig\log4j.xml
ping 127.0.0.1 -n 40  1>NUL
 
java -jar util\com.logicals.lc3.command.jar -port 50055 --createProject -projectName MyProject -targetPath C:\Projects\ -templateName "Neuron Power Engineer Project"
java -jar util\com.logicals.lc3.command.jar -port 50055 --modifyProject -targetFilePath C:\LC3Projects\MyProject\TestNotes.txt -sourceFilePath C:\Templates\DoneTests.txt
java -jar util\com.logicals.lc3.command.jar -port 50055 --removeProjectFile -targetFilePath C:\LC3Projects\MyProject\GenericTestNotes.txt  
java -jar util\com.logicals.lc3.command.jar -port 50055 -shutdown

Konfigurationsdatei für das Protokoll

Diese Datei wird zur Konfiguration des log4j-Protokollierungsmechanismus benötigt. Die Datei gibt an, wie Protokoll-Ereignisse ausgegeben werden.

Konfigurationsdatei für das Protokoll (Beispiel)

 
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration debug="false" xmlns:log4j='http://jakarta.apache.org/log4j/'>
 
  <!-- This configuration logs to console. -->
  <appender name="console" class="org.apache.log4j.ConsoleAppender">
    <param name="target" value="System.out"/>
    <param name="immediateFlush" value="true"/>
    <param name="encoding" value="UTF-8"/>
    <param name="threshold" value="info"/>
    <layout class="org.apache.log4j.PatternLayout">
    <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} %-5p:  %m%n" />
    </layout>
  </appender>
 
  <!-- This configuration logs to a file, with more information than for the console. -->
  <appender name="file" class="org.apache.log4j.DailyRollingFileAppender">
    <param name="file" value="C:\\temp\\logfile.log" />
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern" value="%d{HH:mm:ss} %-5p [THREAD ID=%t] [Method:%M] %c{1}:%L - %m%n" />
    </layout>
  </appender>
  <root>
    <level value="INFO" />
    <appender-ref ref="console" />
    <appender-ref ref="file" />
  </root>
</log4j:configuration>